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PREFACE 


This manual describes the DOS-15 System Generator Utility Program, 
DOSGEN, and gives other information needed by the System Manager for 
installation and maintenance of the DOS-15 system. 

In the preparation of this manual, it was assumed that the reader is 
familiar with the Disk Operating System (DOS-15), including its 
Monitor, and the several Utility Programs -- especially PIP, PATCH, 
and UPDATE. The DOS USER’S MANUAL (DEC-15-ODUMA-B-D) describes the 
general operating procedures for DOS-15. 

PDP-15 UTILITY PROGRAMS 


The PDP-15 Utility Programs manual is comprised of a set of individual 
manuals, each of which describes the operation and use of a PDP-15 
Utility program. The set of manuals which make up the Utility 
Programs manual are listed in an Applications Guide located on the 
following page; the Guide also lists the order number of each manual 
and indicates the currently available monitor systems under which the 
program w T ill operate. Individual utility manuals may be ordered by 
referencing the titles and order numbers specified in the Applications 
Guide. 

Chapters 1 and 2 of this manual describe DOSGEN and its use. Chapter 
3 describes the general sequence of operations to be followed Vvhen 
using DOSGEN. It is recommended that the user read the entire manual 
before installing DOS-15. 
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APPLICATION GUIDE 


PDP-15 UTILITY PROGRAM .MANUALS 


PDP-15 Utility Program Manuals and the Application of Each 



Manual 

Applies to Monitor: 

Title 

Order Number 

(DEC-15- 

DOS 

ADSS 

B/F 

DDT 

Utility Program 

YWZB-DNl 

/ 

/ 

/ 

CHAIN & EXECUTE 
Utility Program 

YWZB-DN2 

/ 

/ 

/ 

SGEN 

ADVANCED Monitor 

YWZB-DN3 


/ 


MTDUMP 

Utility Program 

YWZB-DN4 

/ 

/ 


PATCH 

Utility Program 

UPATA-A-D 

/ 

/ 

/ 

EDIT 

Utility Program 

YWZB-DN6 

/ 

/ 

/ 

UPDATE 

Utility Program 

YWZB-DN7 , 

/ 

/ 

/ 

LINKING LOADER 

YWZB-DN8 

/ 

J 

/ 

PIP 

ADVANCED Monitor 

YWZB-DN9 


/ 

/ 

SRCCOM 

Utility Program 

YWZB-DN11 

✓ 

/ 

/ 

SGEN 

DOS Monitor 

USGNA-A-D 

/ 



PIP 

DOS Monitor 

UPIPA-A-D 

/ 
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CHAPTER 1 
USING DOSGEN 


1.1 CONTEXT 


The DOS System Generator, DOSGEN Vnn, allows the system manager to 
modify an existing DOS system to suit the needs of a particular in¬ 
stallation, DOSGEN does not create a system, but modifies an existing 
one . The DOS disk-restore DECtapes or magtape that Digital Equipment 
Corporation distributes will produce a working Disk Operating System 
when restored to the disk via the DOSSAV program 1 . The system manager 
can initiate a system generation operation in order to tailor this 
basic system to his own needs by issuing the following series of 
commands to the DOS Monitor: 

$MICLOG SYS Required System Manager Password for the basic 
system 

r A RK -14 A (for system generation on RK Disk cartridge)/** Required ^ 

$/ A DK -14 > (for system generation on RF DECdisk) ( ASSIGN / 

VA DP -14 J (for system generation on RP Disk Pack) v statement J 

$SGEN Load command for DOSGEN 

When DOSGEN is loaded, it automatically starts an interactive SGEN 
procedure. Once system generation is complete, the system manager 
should save the changed system via the DOSSAV program. He should 
always retain at least two copies of the system: the original tape(s) 
from DEC, and a copy of the new system. 

When the system manager wishes to do a subsequent system generation, 
he should type the same command series given above, substituting the 
Monitor Identification Code which he supplied during the last system 
generation. 

1.2 ORGANIZATION 

DOSGEN is a single, core-image system program with no overlays. When 
loaded into core DOSGEN tests to ensure that the system owner is 
currently logged in and that the "A" handler of the RF DECdisk or RK 
Disk cartridge or RP Disk Pack is assigned to .DAT-14, DOSGEN exits 
if these requirements are not met. DOSGEN then types out its name, 
version number, and the device and unit number on which the new 
system will reside. 

1 Appendix A describes the DOSSAV program. 
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DOSGEN then proceeds with eight sequentially presented sets of ques¬ 
tions that can modify three basic areas of the system; (1) system 
parameters r (2) I/O, and (3) system programs. The eight sets of 
questions are identified by the letters A through H* Each set is 
started by a key question that describes the drift of the questions 
in that particular set* Key questions start at the left margin, 
questions within a set are tabbed one stop (8 spaces) to the right* 

The user can save time by refusing to consider questions in a par¬ 
ticular set involving an area not to be modified* He can do this by 
responding to the key question of any set with a Carriage Return, 
which effects the acceptance of a set of default answers* This means 
that the parameters covered by the rejected set remain as in the 
previous system. 

DOSGEN provides restart points which coincide with the beginning of 
each set of questions* In general 9 a CTRL P from the keyboard at 
any point before the end of the current set of questions causes a 
return to the start of the current set of questions, and the deletion 
of all answers previously supplied for the current set* Before the 
user terminates a particular set, he should then check all answers 
for that set* If he later finds a mistake after a set is completed, 
he must abort the operation and go through another complete system 
generation to correct the error* A CTRL C, at any time before the 
end of Section H , terminates the system generation, leaving the old 
system unchanged* 

1*3 ANSWERS TO DOSGEN QUESTIONS 
1*3.1 Teleprinter Command Mode 

To save time, DOSGEN supplies a default answer in either parentheses 
or square brackets, with each question* The default answer always 
shows how the previous system looked or in some way indicates no 
change is required. A Carriage RETURN response indicates the user 
accepts the default answer. In the illustration of each question 
where the default may be more than one, this manual indicates the 
possibility with brackets ({}). Thuss 

API { (Y) } 

api i (N) t 
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Y and N are 1-character answers for many of the Yes/No, On/Off class 
of questions« They are self-explanatory. In the case of some ques¬ 
tions, however, a third 1-character choice Is required. In such ques¬ 
tions, the third choice implies "Yes, but ask me questions about the 
details of the subject.” For example. Section B, which concerns de¬ 
vices and device handlers, first asks about each device, deferring ques¬ 
tions about its handlers until necessary. Thus, the question: 

PR? ($) 

asks whether the user wants the Paper Tape Reader. "N" says "NO, de¬ 
lete the Paper Tape Reader and all of its handlers and skips from the 
system." Response "$" or Carriage Return says, "YES, keep the Paper 
Tape Reader and all its handlers and skips as they are." Response "Y" 
says, "YES, keep the Paper Tape Reader, but ask me questions about its 
handlers and skips." ALT MODE alone is echoed , and substitutes 
for "$". For the Y/N/$ type of question, which accepts a 1-character 
answer, a left arrow implies the default and gives a visible answer on 
the printout. (Carriage RETURN is not a printing character.) 

Some questions cannot be answered by a simple yes/no multiple choice 
type of question; for example, the specification of the monitor identi¬ 
fication code (MIC) (paragraph 2.1.4). For such questions the present 
value (or default) is supplied in square brackets rather than paren¬ 
theses. The user may type a single carriage return to continue with 
the present value, or a new value followed by a carriage return. The 
exact form a new value must take is given in the paragraphs on the 
appropriate questions. 

Some questions allow multiple answers; for example, "SKIP MNEMONICS 
IN ORDER" (paragraph 2.4.2). In such instances, the user may type 
several answers on one line, separating each answer from the next by 
a comma. 

Other answers are explained in the relevant parts of Chapter 2. 

1.3.2 DOSGEN Batching Command Mode 

Like other DOS Monitor system programs, DOSGEN may be used in the DOS 
Batching Command Mode . In fact, some features have been added which 
make the batching process easier. These features are required for the 
following reason: For those answers whose defaults are specified in 
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parentheses, DOSGEN reads teleprinter input in Image Alphanumeric Mode. 
Hence, it does not require a Carriage RETURN to complete a .READ. Sys¬ 
tem considerations, however, require that Batching Mode tapes or decks 
be in IOPS ASCII. This means that each line of input must be termi¬ 
nated by a Carriage RETURN» Since lines containing one Carriage RE¬ 
TURN only cannot be generated by the Editor, the default answer must 
always be specified by a left arrow (■*■) * One-character answers in 
teleprinter mode have their Batching Mode equivalents as follows: 


Teleprinter 

Y 

N 

$ 

Carriage RETURN 
or 

Left-arrow («-) 


Batching 

yJ 
N J 
$J 


All of the above types of answers go with questions where the default 
is specified in parentheses. In any case where the default is not 
specified in' parentheses (i.e„, no default, or one in brackets), the 
user should have xx..xjin the batching command string. 


1.4 ERROR MESSAGES 


DOSGEN checks all answers for syntax and acceptability to the DOS 
software. It also does some limited checking for acceptability within 
the current hardware configuration. Whenever DOSGEN finds a wrong 
answer, it types an error message two tabs to the right of the left 
hand margin (16 spaces in). DOSGEN does not check for multiple errors? 
any answers that follow an erroneous answer on the same line are not 
processed, and must be retyped. 

1.5 OPERATION 

When DOSGEN starts operation, it saves an image of the three parameter 
blocks from the system device plus the Storage Allocation Table. 

These blocks contain the old image of the three system information 
blocks; SGNBLK, SYSBLK and COMBLK„ SGNBLK contains information about 
the default settings of key a SCOM registers, the •DAT and *UFDT, plus 
an ordered skip chain, the names of all the handlers, and certain 
information about the devices that the system recognizes. Together, 
SYSBLK and COMBLK occupy two contiguous blocks on the system device. 
They describe the system programs. Figure 1-1, SGNBLK, and Figure 1-2, 
SYSBLK and COMBLK, illustrate the contents of these information blocks. 
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Location 

Value 

0 

000nnn 

1 

000017 

2 

000nnn 

3 

000nnn 

4 

221300 

5 

nnnnnn 

6 

nnnnnn 

7 

nnnnnn 

10 

nnnnnn 

11 

*SIXBT 

12 

nnnnnn 

13 

00000n 

14 

00nnnn 

15 

7777nn 

16 

0nnnnn 

17 

00nnnn 

20 

000nnn 

55 

000nnn 

56 

.SIXBT 

113 

.SIXBT 

114 

nnnnnn 

145 

nnnnnn 

146 

oSIXBT 

• 

.SIXBT 


.SIXBT 


.SIXBT 


000002 


nnnnnn 


nnnnnn 


nnnnnn 


.SIXBT 


000001 


nnnnnn 

344 



J 


Description 


Pointer to first free entry in SGNBLR 
Number of miscellaneous parameters 
Size of .DAT plus size of .UFDT = (number of 
positive .DAT slots + 16)*2. (Initial value 
is 20 positive .DAT slots.) 

Number of skips in Skip Chain. 

System device code. 

Original contents of .SC0Mt4. 

Original contents of e SCOM-f20 o 
Number of words per buffer (.SCOM+27). 

Default number of buffers (.SCOM+26). 

Monitor Identification Code* 

Information on VT and CTRL X (.SCOM+33). 
Default files protection code (.SCOM+54). 

Size of the Resident Monitor Patch Area. 

Minus the number of clock ticks in a second 
(-74 for 60 hz, -62 for 50 hz) 

Spooler area last block #. 

Spooler area size. 

Device assignments for the .DAT (made by 
handler numbers). (Termination at 55 assumes 
20g positive slots.) 

UIC assignments for the .UFDT. (Termination 
at 113 assumes 20 g positive slots.) 

Skip Chain Table (Negative skips in I's 
complement.) (Termination at 145 assumes 32^ 
skips in chain.) 

The last part of the SGNBLK is the Device 
Handler-Skip IOT Table. Each entry starts 
with the •SIXBT representations of all 
handlers for a particular device. (First two 
characters equal device code , for all 
handlers.) Zeroes in the first six bits of 
a word indicates the end of the handler 
names, and says that the rest of the word 
contains the number of skips for this entry ! s 
device. The skip IOT 1 s follow immediately. 

As above, l ! s complement skips indicate 
negative skips. Note, however* the confusing 
fact that a I's complement of a skip IOT is 
a positive number. Thus* 7£fnnnn complemented 
is 07nnnn. 


SGNBLK ends at 344 in the DOS-15 RK05 system 
distributed by Digital Equipment Corporation. 


j 

\ 

j 

j 


i 

! 


Figure 1-1 

SGNBLK for RK05 Based System 
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Word # Value Description 

0 000nnn Pointer to first free word after SYSBLK 

, (There is one set of seven words/core 

7N+1 , SIXBT\ image program/) 

7N+2 .SIXBTi Name of System Program or overlay 

7N+3 nnnnnn Number of first block on system device 

occupied by this program or overlay 

7N+4 0000nn Number of blocks occupied by this 

program or overlay 

7N+5 addres Thirteen-bit first address for this 

program or overlay 

7N+6 p'nnnnn Program size 

7N+7 addres Thirteen-bit starting address for this 

program or overlay 


(free area) 


400 


000010 

401 


. SIXBT-s 
.SIXBTJ 

402 

P 

403 


.SIXBT\ 

• SIXBT- 1 

404 

r 

405 

0 J 

000002 


411 

412 r 

413 o 

g 

414 2 


oDAT&777 
«DAT Sill! 

000005 

.SIXBT \ 
.SIXBT7 
000001 


DAT & 7 7 7 


Number of words in this entry (in this 
case, 10) 

Name of this system program (left- 
justified and zero-filled) 

Name of an overlay (left-justified and 
zero-filled) — overlays are optional 
Number of buffers required by this 
system program (Bits 0-6-0 means the 
end of any overlay names. This is why 
program and overlay names must be 
left-justified.) 

Active .DAT slot 

Active •DAT slot (Note: 777777 for a 
»DAT slot means all positive .DAT slots.) 
Number of words for this entry (in 
this case, 5) 

Name of this system program 

Number of buffers required by this 
program (Note that this program has 
no overlays.) 

• DAT slot for this program 


000400 Pointer to first word in COMBLK (equals 

count from first word in SYSBLK). The 
two contiguous blocks on the system 
device that hold SYSBLK and COMBLK are 
treated by the system as one large 
block. In this case, COMBLK happens to 
start at location 400 of the two blocks 
combined. 

Figure 1-2 


SYSBLK and COMBLK 
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Appendix D contains listings of these information blocks, as supplied 
by DEC• 

Most of DOSGEN's operations consist of building new images of SGNBLK, 
COMBLK and SYSBLK and the Storage Allocation Table. On completion of 
the last set of questions (the "H" set), the DOSGEN disallows commands 
from the teleprinter, writes out the new system block images, and de¬ 
letes any discarded handlers from the IOS User File Directory. (Up to 
that point, the current system has remained unchanged.) It is up to 
the user to insert added handlers and system programs. Handlers can 
be added via PIP. PATCH can be used to add core-image system programs 
for which DOSGEN has allocated space. 
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CHAPTER 2 

DETAILED DESCRIPTION OF OPERATION 

This section describes the options available to the DOSGEN user* and 
explains some of the planning necessary for determining an optimum 
configuration for a particular installation. Each first order 
(2-digit) paragraph denotes a new set of questions. Each second order 
(3-digit) paragraph presents an individual question and a description 
of its meaning and use. 

2.1 A. ALTER SYSTEM PARAMETERS? (N) 

The "A" section defines those system parameters that do not fall under 
I/O or system program categories. Some are default parameters which 
can be modified by commands to the Nonresident Monitor. Others can 
only be modified by DOSGEN. Figure 2-1 f Section A Questions* illus¬ 
trates this section. 

2.1.1 API? {} 

This asks whether API is available on the system* and whether the user 
wishes the default to be API on or off. A "Y" response makes "API ON" 
the default condition. An "N" answer makes "API OFF" the default. 

The Nonresident Monitor’s API ON/OFF command can change the state of 
API temporarily. 

2.1.2 33TTY? {} 

This asks which keyboard (KSR-33 or KSR-35) is usually available for 
command inputs. The Resident Monitor's teleprinter handler handles 
both machines with no modification. It simply needs to know which 
console it is talking to. An "N" response makes the Model 35 key¬ 
board the default machine. A "Y" response makes Model 33 the default. 
The Nonresident Monitor's 33TTY command can change the default 
temporarily. The KSR-33 MODE causes the TTA handler to simulate the 
TAB function on the KSR-33 and LA30 Teleprinter. Use of an LA30 for 
the console device requires that KSR-33 mode be on; i.e. a "Y" res¬ 
ponse is required. 
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DOSGEN V3A000 


SYSTEM UPDATE ON DK0 
A. ALTER SYSTEM PARAMETERS? (N) Y 
API? CN) Y 
33TTY? CN) Y 
LA30 ? CN ) N 
MICCSYS3 FOO 
DEFAULT # BUFFEnS [33 4 
« WORDS/BUFFERC 500 3 47b 
UC15 CONFIG? CN ) N 
LX'ihA 4K? CN ) N 

DEFAULT FILES PROTECTION CODE[2 3 1 

RESIDENT PA1CH AREA SI7EC03 1200 
PAGE MODE SYSTEM? CN ) N 

A 0 rps’ cy) Y For an RF15 or RP02 system© 


DOSGEN V3A000 

SYSTEM UPDATE ON RK8 
R ALTER SYSTEM PARAMETERS? CN) V 
API? CY) V 
33TTY? CY) V 
LA30? CY) V 
MICE SYS] XVZ 
DEFAULT # BUFFERS!! 3 3 4 
# WORDS/BUFFERC5003 525 
UC15 CONFIG? CY) 

SPOOLER START BLK # [112073 
SPOOLER SIZE C50063 4000 
EXTRA 4K? CN) V 

DEFAULT FILES PROTECTION CODEC £ 3 1 
RESIDENT PATCH AREA SI2EC03 1200 

For an RK05 system. 

PAGE MODE SYSTEM? CY) V 
60 CPS? CY) V 

Figure 2-1 
Section A Questions 
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2.1.3 LA30? { } 


This question asks if the system has a 30 CPS, LA30 as the console 
device. An "K" response makes the Model 35 keyboard the default con¬ 
sole device. A "Y” response makes 30 CPS, LA30 the default. The 
Non-resident Monitor 8 s LA30 command can change the default temporarily. 
LA30 mode causes the TTA handler to insert several Null characters 
after a CARRIAGE RETURN to improve LA30 Timing on output. LA30 mode 
and KSR-33 mode (paragraph 2.1.2) are totally independent? both must 
be on ("Y" responses) for an LA30 console device. 

2.1.4 MIC [mic] 

This question prints the current Monitor Identification Code (MIC) in 
square brackets. A Carriage Return entry retains the old MIC. If the 
user wishes to change the current MIC, he should type exactly three 
printing characters, followed by a Carriage Return. If possible, the 
user should avoid MIC codes that equal User Identification Codes (UIC’s) 
current to the system. In particular, he must avoid the following 
UIC’s: ???, PAG, BNK, ICS, CTP and SCR. DOSGEN does not accept non¬ 

printing characters as part of an MIC. 

2.1.5 DEFAULT # BUFFERS[n] 

This command requests a default number of buffers to be allocated for 
user programs and non-core image system programs. The number in 
square brackets is the old number. If the user wishes to retain the 
old default number, he should type a Carriage Return. DOSGEN accepts 
any set of six or fewer octal digits followed by a Carriage Return as 
the octal number. The Master Tapes which Digital Equipment Corpora¬ 
tion distributes indicate three (3) as a default number. The user 
must consider the trade-off of the available core in his installation 
(systems with little memory might need a smaller number of buffers) 
versus the convenience of a large number of buffers. 

This parameter does not affect core-image system programs, which al¬ 
ways get as many buffers as they need. Users whose programs need a 
different number of buffers may use the BUFFS Nonresident Monitor 
command to allocate the exact number of buffers needed. 
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2.1.6 # WORDS/BUFFER [nnnj 


This requests the number of words per buffer* and prints the old num¬ 
ber (in octal) in square brackets. A decision regarding an efficient 
size for the buffers requires some knowledge of the disk handlers 
which use them. The handlers break buffers from the pool into three 
parts; (1) File Information (about 40 g words)* (2) the Block List — 
addresses of pre-allocated blocks (between 4 and 374g addresses* in¬ 
clusive) * and (3) the data buffer (400 8 words). Thus* buffers must 
be at least 444 g words long. 

The disk handlers do not use extra words in buffers longer than 1034^. 
This* therefore* may be an upper limit on buffer size* unless other 
programs need more space in their buffers. The larger the Block List -- 
that is* the larger the buffer — the faster is the output. Smaller 
Block Lists may give more efficient allocation of disk space* and 
certainly save core. 

Any number typed is interpreted as an octal number. 

2.1.7 UC15 CONFIG? 

This asks whether the system is the RK05 based dual processor 
UNICHANNEL-15. DOSGEN uses this information to determine if further 
questioning is necessary. 

If the answer to this question is "Y" the following two questions are 
asked. If the answer is "N"* DOSGEN does not ask the following two 
questions and skips to item 2.1.8. 

2.1.7.1 SPOOLER START BLK. # [nnnnn] 

This requests the spooler area starting block number on the RK disk 
and prints the current number in square brackets. Normally the end 
portion (based on block numbers) of the RK disk (currently only unit 0) 
is pre-allocated for the SPOOLER. This area is defined by the spooler 
area start block number and the spooler size in blocks* as indicated 
by the shaded area in Figure 2-2. 


1 lf the RK05 is not the system disk (UC15 option) * then an "N ,s reply 
must be given to this question® 
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block # 0 



Spooler area 
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Figure 2-2 

Spooler Start Block Area 

Spooled data is stored starting from block BB (computed 
from the start block number and size)• 


Users who are not familiar with the disk file structure and Storage 
Allocation Table (SAT) should not change this starting block number 
for the following reasoni The current system is built for the maximum 
possible size of spooler area. As a result the only possible change 
in size is a reduction of it* This facility is provided by reducing 
the value of the spooler size only* Values of BB like BB 88 (resulting 
from a smaller value of the start block # with no change in the 
spooler size) are illegal unless the SAT blocks are suitable updated 
(new blocks pre-allocated) to reflect this change* 

For users who are familiar with the disk file structure and the SAT 
block this provides the facility for changing the location of the 
spooler area on the disk* 
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2*1,7,2 SPOOLER SIZE [nnnn] 


This requests the spooler area size (in block numbers) on the disk 
and prints the current size in square brackets* All users are pro¬ 
vided with the facility of reducing the spooler area (to free space 
on disk) by reducing this size* Figure 2-2 illustrates an instance 
where this is done to result in a new value of BB , BB s * DOSGEN 
deallocates the disk blocks between BB and BB 3 • 

The smallest legal value of the spooler size is 64 if spooling of 
data is still desired* Users are warned that as the spooler size is 
reduced the system is generally slowed down if data is being spooled* 
This is because spooling of data normally occurs at a much faster 
rate than the de-spooling of data and* as a result, after a certain 
period of time, the entire spooler area is full of spooled data* The 
spooler then temporarily halts spooling operations until disk blocks 
are freed by de-spooling of data* 

The entire spooler area can be completely freed if spooling is not 
desired, 

2.1.8 EXTRA 4K? { } 

For systems with an odd number of memory pages, a ir Y" answer allows 
the loaders to use the highest page in memory* For systems with no 
extra 4K page, the user should type S, N", 

2.1.9 DEFAULT FILES PROTECTION CODE [n] 


This requests the default file protection code, and prints the old 
code in square brackets* The possible codes and their meanings ares 


Code = 1 Unprotected, with the exception that the file 
may not be deleted and the number of blocks 
may not change, if the directory is protected* 

Code = 2 Write protected, if directory protected* 


Code = 3 


Read/Write protected, if directory protected* 
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DOSGEN accepts any 1-digit octal number, but the numbers 0, 4, 5, 6, 
and 7 are meaningless in this system. 

The default protection code for User File Directories is always 1, 
protected, and may not be changed by DOSGEN. 

A user may temporarily change the default protection by means of the 
Nonresident Monitor Command PROTECT. 

2.1.10 RESIDENT PATCH AREA SIZE [nnn] 

This requests the Resident Monitor's Patch area size and prints the 
old number in square brackets. The Resident Monitor's Patch Area is 
a number of reserved registers (no bigger than 3000 Q ) located just 
above the Resident Monitor. The System Loader does not refresh it, 
except on Bootstrap loads, restarts, and any of the QFILE GET commands. 
The area may be used for patching the system or for communication 
among several programs in different core loads. 


DOSGEN interprets any number typed as an octal number. The digits 8 
and 9, therefore, are not accepted. 

2.1.11 PAGE MODE SYSTEM? { } 

This requests the default addressing mode. A "Y" response makes page 
addressing the default mode. An "N" response makes bank mode the 
default. Users may temporarily change the mode via the PAGE ON/OFF 
or BANK ON/OFF Nonresident Monitor commands. 

2.1.12 60 CPS? { } 

This requests the line frequency at the installation. Installations 
with 60hz line frequency require a "Y" answer; those with 50hz require 
an "N" response. 
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2.2 B. ALTER I/O DEVICES OR HANDLERS? (N) 


This set of questions allows the user to delete or retain devices and 
all their handlers, and allows a third option of retaining the refer¬ 
ence to the device, and then retaining, deleting or adding handlers 
and skips for a particular device. The printout given in Figure 2-3 
illustrates the use of this section* 


Section B refers to all devices currently in the system by a 
2-character device code. The device codes for those device handlers 
included in the Master Tapes supplied by the Digital Equipment 
Corporation are? 


CD 

Card Reader (CR03B or CR15 or 

CRH) 

DK 

RF15 Disk Control 


DP 

RP15 Disk Pack Control 


DT 

DECtape (TCI5 DECtape Control) 

LK 

LK35 Keyboard 


LP 

Line Printer (either LP15C or 

LP15F or LP11/LS11) 

LT 

LT15/LT19 Terminal Interface 

(Dummy Handler) 

MT 

MAGtape 


PP 

Paper Tape Punch (PC15) 


PR 

Paper Tape Reader (PC15) 


RK 

RK05 Disk Cartridge Control 


VP 

VP Point Plotting Display 


VT 

VT15 Graphic Display Console 


vw 

Writing Tablet 


XY 

XYll Plotter 



(TT t which means teleprinter, is not included in this set of questions, 
because DOS uses the teleprinter as a console command device.) 


The device handler names used in Section B are printed as 3-character 
names. In reality, handler names are four characters long, but this 
section truncates the last character, a period („) . The first two 
characters must be the 2-character device code for the handler’s 
device. The third character must be alphabetic. 

DOSGEN starts this set of questions by asking whether the user wishes 
to delete discarded handlers from IOS. Deletion saves space on the 
system device. 

DOSGEN then begins asking key questions for each device currently on 
the system: 

XX? ($) (where XX stands for any device code) 
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If the user answers with a Carriage Return or DOSGEN retains 

the device and all its skips and handlers as they were in the previous 
system. If the user answers "N", DOSGEN deletes all information about 
that device and its handlers, and all its skips from the Skip Chain. 
(Deletion of handlers from the handler UFD , IOS, does not occur until 
the termination of Section H.) 

If the user answers "Y", DOSGEN asks specific questions about the 
handlers and skips 'for the device in question. 

2.2.1 XXX? (Y) 


(where XXX stands for any handler name) 

DOSGEN asks this question for each handler the device has in IOS 0 A 
"Y" response retains the handler; an ”N" response deletes it. 

NOTE 


DOSGEN does not allow the user to 
delete the n A ,r handler for the sys¬ 
tem device (DKA ., RKA. or DPA.). 

2.2.2 NEW HANDLERS; 

When DOSGEN has asked a question for each of the device handlers 
currently in IOS, it asks whether the user wishes to add any new 
handlers. It makes no sense to "add" a handler name which has just 
been deleted. If the user wishes to change a handler, he may use PIP 
to transfer a new one to IOS. PIP automatically deletes the old one 
if the user transfers a new one with the same name . New handler 
names should follow the rules outlined in paragraph 2.2. When the 
user has no more handlers to add, he should simply type a Carriage 
Return. 

Adding handler names only makes them "logically" present. The user 
must call PIP to transfer the handlers to the IPS UFD, in order to 
make handlers physically present . DOSGEN warns the user about missing 
handlers at the end of Section C. File names for handlers in IOS 
must have the same name as the handler global and the entry point 
label and a "BIN" extension (e.g., .GLOBL DKA. ,DKA. DAC CALP, 

or DKA. BIN). 
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2,2.3 OLD SKIPS 


Presumably, the user changes old skips only in the case where they 
were incorrectly inserted. In any case, after the user has indicated 
he has no more handlers to add for the current device, DOSGEN prints 
the skips for this device that are in SGNBLK (whether or not these 
skips are in the skip chain). DOSGEN prints skips in the following 
format: 


devskp = nnnnnn? (Y) 

A Carriage RETURN or "Y" accepts the old skip; an "N" deletes the skip. 
2.2.4 NEW SKIPS % 

When DOSGEN has exhausted the skips for the current device as they 
were in the old system, it requests any new skips. New skips should 
be typed in the following formats 

devskp = nnnnnn 

where devskp has no more than six characters, and nnnnnn is a legiti¬ 
mate device skip. DOSGEN performs the following tests to determine 
if a skip is legitimates 

1) Must be IOT. I.e., must be of the form 7$nnnn. 

2) Bit 14 must be zero — the skip may not clear the accumula¬ 
tor. 

3) The low order octal digit must be a 1 — it must be a skip 
IOT and not some other kind. This check may be overridden 
by the user by typing ,r Y 8t to the question 2 

devskp=nnnnnn IS NOT A STANDARD SKIP IOT. 

DO YOU WISH IT ACCEPTED? (N) 

Any other answer causes the skip to be ignored. 

If a skip is rejected for any of the above reasons,DOSGEN re-prompts with 
the ">" symbol which requests another skip. 

Users should not insert skips (IOT 8 s) which can in any way modify the 
contents of the accumulator. Such IOT ff s will cause serious, timing- 
dependent bugs in DOS-15. For similar reasons users are also cautioned 
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against using skip IOT* s which in any way modify device status infor¬ 
mation* 

When the user types a Carriage RETURN after the DOSGEN proceeds 

to the next device. Negative skips (that is, those which skip on 
"OFF", not "ON”) should be preceded by a minus sign (-), to indicate 
that they are negatives 

devskp = -nnnnnn 

2*3 C. ADD NEW DEVICE? (N) 

When DOSGEN has finished with Section B, it asks whether the user 
wishes to add a new device. Section C differs from other sections 
in that restarts (CTRL P) only delete information added for the 
current device. 

That is, if the user adds devices AA, BB, and CC, but types CTRL P 
during the CC operation, DOSGEN returns to a point just after the 
completion of the BB device insertion. 

When the user has no more devices to add -- that is, when he answers 
the key question with an "N" or Carriage Return, DOSGEN reminds him 
of all the handlers he has added to the system, but which are not 
yet present in IOS„ He can add them later, via PIP * The printout 
shown in Figure 2-4 illustrates the use of this Section. 

2.3.1 DEVICE CODE [ ] 

Here, the user may type any two alphameric characters that DOSGEN 
cannot interpret as an octal number. It is recommended, however, 
that the user give only alphabetic characters, as any numerals might 
be confused with a unit number. DOSGEN does not accept any input 
other than two alphameric characters. There is no default for this 
question; DOSGEN assumes that if the user answered the Section C 
question with a "Y", he has a device code to add. DOSGEN makes no 
assumption about which device it is. 
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2.3.2 NEW HANDLERS s 


Here, the user should add all the handlers he will use for the new 
device. The names should follow the rules for handler names outlined 
in paragraph 2.2 with the exception that the user must not type the 
final period (.). 

2.3.3 NEW SKIPS: 

The new skips for the device should follow the format outlined in 
Paragraph 2.2.4 DOSGEN adds all new skips to the end of the Skip 
Chain. The user may change the order of the Skip Chain in Section D. 

When the user has no more skips to add, DOSGEN repeats the key 
question for Section C. 

C. ADD NEW DEVICE? (N) 

If the user has another new device, he may add it now. 
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2.4 D. CHANGE SKIP CHAIN? (N) 


When the user has responded to the key question for Section C with an 
"N" or a Carriage Return, DOSGEN proceeds to Section D, which allows 
the user to change the Skip Chain order and delete skips. The user 
may not add any skips in this section. The printout of Figure 2-5 
illustrates the uses of this Section. 

2.4.1 DISPLAY SKIP CHAIN? (Y) 

In most instances, the user wishes to see all skip mnemonics and 
acronyms in the old system, plus those he has just added. If he 
answers "Y" or Carriage Return, DOSGEN types: DEFAULT SKIP CHAIN 
ORDER, followed by the old Skip Chain with new skips at the end. 


2.4.2 SKIP MNEMONICS IN ORDER: 


Users have two basic options for this part: accept the whole chain as 
is, or retype the entire chain, in a new order. The user may type a 
single Carriage RETURN in response to the "SKIP MNEMONICS IN ORDER:" 
question, and obtain the old chain order, with any new skips at the 
end of the chain. If he types any mnemonic, however, he must account 
for all of the skips. When the user responds to DOSGEN's request for 
the next skip (>) with an ALT MODE, DOSGEN types and the first 

skip in the old chain that has not already been selected. When the 
user responds to the ">" with a Carriage RETURN, DOSGEN deletes all 
unlisted skips, freezes the new order, and continues on to Section E„ 


Two warnings are in order: (1) Negative skips should be at the end 

of the chain. Illegal interrupts may otherwise occur when the 
peripheral device is down. (No standard DOS devices have negative 
skips.) (2) Beware of changing the relative order of the chain, as 
supplied by DEC. For instance, the clock interrupt must come before 
the printer. 

2.5 E. ALTER DEVICE PARAMETERS? (N) 

2.5.1 7-CHANNEL MAGTAPE { } 

The user should choose the proper default. "N" gives 9-channel. The 
printout for this section is shown in Figure 2-6. 


2-15 



u . C HmN tic. SKIP C HA IN ? CN ) V 


DISPLAY SKIP 

CHAIN? CY) Y 

> $ S P D I 

DEFACEI SKIP 

CHAIN OKbbh % 

> Si-Pi SK 

SPFAL 

DiDF 


> SSDDF 

DbSF 

DPS J 1 


> SCKSI 

M SF 

SPJj I 


>SCPSD 

/Pi SK 
b LJ D F 


>$LPSF 

CHS I 

Cwvbb 


> SCLSF 

LFSP 

CLbF 


>£KSF 

i i S F 

PSF 


> SP S F 

KbF 

KbF 1 


> SKSF 

ISF 

D 1 L F 


> SKSF1 

DPS t 

PPSNE 


> SI SF 

P>P s K 

SHE 


> SDiE F 

KbF 1 2 

KSf 2 


> SDPbE 

KbF 3 

KS ¥ A 


> SMPSNE 

Kb F b 

K S S F 


> SiVpSK 

WCSf 

ADSF 


> SSPE 

> SKbF1 



>SKSF2 

SKIP KNEKONICS 

IN OhDEPs 

> SKSF3 

>ADSF 


>SKbF4 

> SSP F A L 


> SKSF 5 

> S D i D F 


>S 


> V.CSF 


>ibsS F 

> &DPS J 

> PbbF 

> i M 'i s F 


Figure 2-5 


! for RK05 based UC15 systems RKSF will appear here before DPSJ* 

"for RK05 based UC15 systems CDSF, LSSF and XYSF will appear here (in 
that order) before KSF1» 
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E a ALTER DEVICE PARAMETERS? 'N) Y 
7 CHANNEL MAGTAPE? (Y) N 














2.5.2 LINE PRINTER SIZE (80, 120, OR 132) [nnn] 


Acceptable responses to this question are 80, 120, or 132, or a Car¬ 
riage Return. A Carriage Return retains the old line size, printed in 
square brackets. 

2.5.3 VT ON: {} 

This requests the default setting for the CTRL X option. A "Y" makes 
VT ON the default. An "N" makes VT OFF the default. DOSGEN does not 
ask this question or the next one if the VT is not on the system. 

2.5.4 HALF ON? { } 

This requests the default setting for the half-screen setting for the 
CTRL X option. An "N n response makes HALF OFF the default. A "Y" 
response makes HALF ON the default. 

2.6 F„ ALTER .DAT SLOTS? (N) 

This section allows the user to alter the number of .DAT slots, which 
is a permanent change to the system (until the next System Generation), 
and to make the default assignments to both the .DAT slots and the 
«UFDT slots. The operator may temporarily change the assignments via 
the ASSIGN (A) command to the Nonresident Monitor. (See Figure 2-7.) 

2.6.1 # OF POSITIVE .DAT SLOTS [nn] 

This asks the number of positive .DAT slots for the new system, and 
indicates the old number in square brackets. The number of negative 
.DAT slots is fixed at 15. DOSGEN accepts any octal number from 1 to 
77, inclusive. Each .DAT slot adds two registers to the size of the 
Resident Monitor and two parameters to SGNBLK -- one for the .DAT slot 
entry, and one for the .UFDT entry. Users with a great deal of core 
should still be careful about too many .DAT slots. That might cause 
SGNBLK overflow and an abort from the system generation. Further, OTS 
users must reassemble FIOPS and .FLTB in order to use more than 20 8 
.DAT slots. See Appendix C. 

2.6.2 DISPLAY .DAT SLOTS (Y) 

If the user wishes to change any assignments, he may request their 
current assignments by answering "Y ,! or Carriage Return. This has the 
effect of a REQUEST command to the Nonresident Monitor. 


2-18 



2.6,3 NEW ASSIGNMENTS : 


The user may make new default assignments to the .DAT and/or .UFDT by 
using the same ASSIGN (A) commands he would use to the Nonresident 
Monitor. When the user has no more new assignments, he should type 
Carriage Return when DOSGEN types a new angle bracket (>). UIC in a 
»UFDT slot means the UIC currently logged in is given to that .UFDT 
slot. SYS in a »UFDT slot means either BNK or PAG will be assigned 
to that slot by the loaders (depending on the addressing mode of the 
load). Any other three letters are retained unless changed via an 
ASSIGN command. 

2.7 Go CHANGE SYS FILES? (N) 

With the exception of the first question* which refers to the size of 
the fQAREA, this refers to the core-image system programs currently 
listed in SYSBLK and COMBLK. This section allows no additions. The 
printout given in Figure 2-8 illustrates the use of this section. 

2.7.1 fQ AREA SIZE (NONE,16K,20K,24K,28K,32K) [nn] 

DOSGEN does not ask this question for Disk Pack or Disk Cartridge sys¬ 
tems -- they always receive 32K. 

This questions allows the DECdisk user to set the tQ AREA size. Users 
with an RF disk system device may wish to delete the iQ AREA. In that 
case, they should type NONE, in response to this question. The Resi¬ 
dent Monitor does not allow dumps to a fQ AREA on the RF disk that is 
smaller than the current core size, or to a nonexistent area. The 
user should therefore avoid having an area which is smaller than his 
core size -- it would simply waste space. "K J " must follow the num¬ 
ber 16, 20, 24, 28, or 32. 

If the user needs to make the fQ AREA larger, DOSGEN tries to find 
enough contiguous free blocks to hold the new one. If this proves 
impossible, special steps may need to be taken. Refer to paragraph 
2.7.2.2 for those steps. 



!>-——- ---.-.— 

G. CHANGE SYS FILES? CN) Y 

tG AREA SIZECNONE, 16K,20K,24K,28K,32KM32K] 16K 

TO BE KEPT? 

DOS 15? ($) $ 

EDIT? ($) N 

EDITVP? ($) $ 

EDITVT? <$) N 

PIP? ($> $ 

MACRO? ($) $ 

CHAIN? (S) $ 

F4? (S) $ 

DUMP? <$) $ 

DTCOPY? ($) $ 

PATCH? ($) $ 

UPDATE? ($) $ 

SPCCOM? (£) N 

8TRAN? ($) N 

89TRAN? ($> N 

MTDUMP? <$) N 

QFILE? ($) $ 

SGEN? ($) $ 


Figure 2-8 

for RK05 based UC15 systems DOSGEN will type: 

MACH ($) 

SPOOL($) 

after SGEN ($). 
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2.7.2 TC BE KEPT: 


syspro? ($) 

After the +Q AREA size has been defined, DOSGEN asks questions about 
each core-image system program currently on the systemin the order 
that it finds them in COMBLK. A response of ,8 $" or Carriage Return 
instructs DOSGEN to retain all information about the last-named system 
program. A response of "Y” instructs DOSGEN to retain the program 8 s 
name in SYSBLK and COMBLK, but implies that the user wishes to change 
some of the information about the program, as listed in SYSBLK and 
COMBLK» An "N" deletes the program from the system. DOSGEN does not 
allow D0S15 to be deleted. 

2.7.2.1 ovrlay (Y) (where "ovrlay" is the name of any 

currently listed overlay) 

If the user responds to a system program name with a "Y", DOSGEN 
first lists each of the program's overlays, if any. These are Yes/No 
answers. 

A "Y" or Carriage Return response retains that overlay, and an ”N M 
response deletes it. 

2.7.2.2 OVERLAY NAME [] 

If the user wishes to add any overlays to the current system program, 
he should type the names at this point. DOSGEN rejects names which 
are more than six characters long, or are the same as any Nonresident 
Monitor or PATCH command. If the named overlay is already listed in 
SYSBLK, DOSGEN requests the next overlay. If not, DOSGEN requests: 

2.7.2.3 # OF BLOCKS [] 

The user should type the number of blocks required for the new system 
program. If the number is legal, DOSGEN tests whether there are as 
many contiguous free blocks on the system device as are necessary to 
hold the new overlay. DOSGEN starts testing at block 0 of the system 
device, and stops as soon as it finds enough blocks. DOSGEN then 
updates its image of the Storage Allocation Table (SAT) to indicate 
that those blocks are occupied. 
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Note that when disk space is tight, and the user wishes to add several 
system programs and overlays, DOSGEN may not allocate disk space effi¬ 
ciently. In an extreme case, the user may need to first transfer the 
BNK and PAG UFD's (or even all of IOS, except the system device's "A" 
handler) off the disk via PIP, and then do one pass through DOSGEN to 
delete all unwanted system programs. Then the user must do enough 
succeeding passes to ensure that system programs are added in order of 
size, with the largest first. Finally, the user should transfer the 
BNK and PAG UFD's back, via PIP. This allows the UFD files, which 
need not be in contiguous blocks, to use the noncontiguous blocks. 

Ordinarily, the procedure outlined in Chapter 3 should be sufficient 
to free all necessary disk space. 


NOTE 


New overlays or system programs 
must run in Bank Mode. Use CHAIN 
for Page Mode programs. 


2.7.2.4 BUFFS [nn] 

This question indicates the number of buffers previously allocated for 
this system program, and asks whether the user wishes to change the 
number. DOSGEN does not check whether the number of buffers allocated 
is compatible with the program. That is the user's responsibility. 

2.7.2.5 .DAT SLOT nn? (Y) 

After the user has indicated the number of buffers for this program, 
DOSGEN asks him to check the .DAT slots required. It first lists the 
°ld ones. If the user types Y or Carriage Return, DOSGEN retains the 
listed .DAT slot. An "N" deletes the listed .DAT slot. 

2.7.2.6 .DAT SLOTS 

After checking the old .DAT slots, the user should add any new ones 
the program needs. The .DAT slots added must be legal, as determined 
in Section F. All positive .DAT slots may be obtained by typing "ALL". 
If the user has added an overlay, he should add any .DAT slots needed 
by the overlay but not listed by DOSGEN for the system program. 
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2.8 H. ADD SYS PROG? (N) 


This section allows users to add the names of new core-image system 
programs and their overlays to SYSBLK and COMBLK. Restarts in this 
section delete only the current system program, just as they do for 
new devices f Section C» 

The printout given in Figure 2-9 illustrates the use of this section. 

2.8.1 PROG NAME [] 

Names must conform to the rules for system program names outlined in 
paragraph 2.7.2.2. There is no default for this question. 

2.8.2 # OF BLOCKS [] 

This question works just like that for overlays,, described in paragraph 
2.V.2.2. There is no default for this question. 

2.8.3 OVERLAY NAME [] 

Any overlay names must conform to the rules for system program names 
outlined in Paragraph 2.7.2.2. If the overlay name is not already 
listed in SYSBLK t DOSGEN requests : 

# OF BLOCKS [] 

2.8.4 BUFFS [0] 

The user should enter the octal number of buffers needed for the new 
system program. 

2*8.5 .DAT SLOTSs 

The user should list the octal numbers of all .DAT slots needed by the 
new system program, or any of its overlays. The response "ALL J " ob¬ 
tains all positive .DAT slots. 

After the user has entered all necessary •DAT slots, he should type a 
Carriage Return in response to the ">" symbol typed by DOSGEN. This 
returns him to the start of Section H, 
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ADD SYS PROG? (N; Y 

PROG NAMEC] ADMON 
f* OF BLOCKS[ ] 7 
OVERLAY NAMEC] ADMON1 
# OF BLOCKSt ] 3 
OVERLAY NAMEC 3 
BUFFS[ 0] 4 
.DAT SLOTS? 
>11,12,13,14,15 


ADD SYS PROG? CN> N 


MODIFYING SYSTEM(tP,tC IGNORED) 

DELETED HANDLERS: 

DKC. 

DPA. 

DPB „ 

DPC. 

MT A » 

MTC. 

MTF. 

CDB. 

VTA. 

VWA • 

LKA . 

SGEN COMPLETE 


Figure 2-9 
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If the user types Carriage Return or "N” to the key question for 
Section H, DOSGEN disallows CTRL P or CTRL C, modifies the system, and 
returns to the monitor. At this point, the user must do a Bootstrap 
restart, in order to bring in the modified system. 
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CHAPTER 3 

DOSGEN AND ITS CONTEXT 
3.1 BUILDING DOS-15 FOR THE FIRST TIME 

Digital Equipment Corporation supplies DOS-15 on disk restore tapes — 
either one 7- or 9-track magnetic tape, or two DECtapes for RF15 and 
RP02 systems and eight DECtapes for RK05 systems * In addition, users 
with optional, Floating Point Hardware should obtain a tape with the 
Floating Point FORTRAN? and users with Object Time Systems or 
UNICHANNEL-15 hardware (for RF15 and RP$2 based systems) should 
obtain a DECtape or magnetic tape and five paper tapes for PDP-11 and 
PDP-15 related software to accommodate those options. The disk 
restore tape(s) should be copied onto the system device via the 
DOSSAV program• Appendix A describes DOSSAV operation• 


After the completion of a DOSSAV run from the DEC restore tapes to the 
system device (disk), the disk containss 

1. A working DOS-15 system 

2. Completed images of three system information blocks z 

SGNBLK, SYSBLK, and COMBLK• 

3. Core-image files of the following system programs s 

D0S15, the Nonresident Monitor 

RESMON, the Resident Monitor 

• SYSLD , the System Loader 

EDIT 

EDITVP 

EDITVT 

PIP 

QFILE 

MACRO 

CREF, MACRO ? s overlay for pass three 
CHAIN 

F4, the FORTRAN program for PDP-15 machines without 
floating point hardware 

DUMP 

DTCOPY 

PATCH 

UPDATE 

SRCCOM 

8 TRAN 

89TRAN 
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MTDUMP 

DOSGEN 


and the following for RKQ5 based UC15 systems only 
MAC11 (for 8K, PDP-11 local memory configuration) 

SPOOL (for LP11/LS11 line printer and XYll plotter) 

The DOS-15 User's Manual, DEC-15-ODUMA-B-D gives brief 
descriptions of all these system programs« 

Relocatable binary files in the IOS UFD„ These files are 
handlers for the following devicess 

RK05 Disk Cartridge Control (for RK05 based UC15 systems 
only) 

RF15 DECdisk Control 
RP15 Disk Pack Control 

PC15 High-Speed Paper Tape Reader and Punch Control 
VP15 Point Plotting Display 
VT15 Graphic Display Processor 
TC59 Magnetic Tape Control 

LP15C and LP15F Line Printers or LP11 and LS11 Line 
Printers (for RK05 based UC15 systems only) 

LK35 Keyboard 
TC15 DECtape Control 
CR03B Card Reader Control 
VW01 Writing Tablet 

XYll Plotter (for RK05 based UC15 systems only) 

LT15/LT19 Terminal Interface (Dummy Handler) 

Appendix B contains a listing of IOS, as supplied by the 
Digital Equipment Corporation* 

Relocatable binary files in the BNK and PAG UFD 9 s. These 
files are the relocatable system programs: EXECUTE, * LOAD, 
FOCAL, and DDT, plus *LIBR, the system library* They load 
in Bank and Page Mode systems, respectively* Appendix B 
contains a listing of the BNK and PAG UFD 9 s as supplied by 
DEC * 

Several source and binary files in the PER UFD. These files 
are for optional peripherals not included in the majority 
of the systems served by DOS-15, and for PDP-9 owners who 
wish to use DOS-15. Appendix C lists the PER UFD, as sup¬ 
plied by DEC, and describes the use of the routines con¬ 
tained in PER. These files are supplied to RF15 systems 
on a separate DECtape or magnetic tape. 



7. A 32K CTRL Q Area. 

8. SCR, the default UFD, SCR will be empty. 

The above-mentioned files and information blocks fit on the smallest 
system device supported by DOS-15 (a single-platter RF15 DECdisk or a 
single drive RP02/RK05 disk). Part of the system generation process 
is designed to free the system device blocks occupied by unneeded 
handlers and system programs. This is especially important on a 1- 
or 2-platter DECdisk system or a 1-drive RK05 system to which the user 
intends to add his own system programs,. The following prcedure frees 
disk storage and sets up a new system in an orderly fashions 

NOTE 


The user should be logged in under 
the Monitor Identification Code for 
all the following operations. 

3.1.1 Preliminary DOSGEN Run 

Call DOSGEN, set up the correct system parameters, and delete all 
undesired device handlers and system programs. Do not add any new 
handlers or programs. If a DECdisk system and the computer's main 
memory hold less than 32K words, reduce the CTRL Q area, 

Users with neither an LT15 nor an LT19 terminal interface should delete 
the LT device handler (LTX.) and all its associated skips. Users 
with an LT15 or LT19 should delete skips which correspond to lines 
that do not exist on their system® Skip mnemonics are of the form KSFn r 
where n is a line number between 1 and 16 inclusive. Installations with 
an LT15 or LT19 should retain the LTX. handler and skips for any lines 
which are present regardless of whether or not the installation plans 
to use this equipment under DOS-15. (Exception — users with only a 
single line who are keeping the LKA a LK35 keyboard handler with which 
to drive it should delete LTX. and all of its skips). Furthermore, 
the skips must be retained in the skip chain. In handling spurious 
interrupts (such as might be caused by accidentally striking a key on 
an LT19 keyboard) DOS-15 determines whether or not a particular line 
is present -- and thus whether an interrupt should be ignored or cause 
an error — by whether or not a skip for that line is in the skip 
chain. The dummy handler LTX. is present solely for the purpose of 
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getting the appropriate skips into the skip chain ~ any attempt to use 
LTX„ to perform any function will cause an I0PS6 error. 

For similar reasons the VPA. device handler should be retained on in¬ 
stallation with a VP15 regardless of whether or not the VP15 is going 
to be used. If this is not done, spurious interrupts (caused by 
depressing the VP15 erase button) may crash the system. 


Users with a single drive RK05 system are recommended to reduce the 
spooler area (as explained in section 2.1.7) if the spooled I/O 
devices are not going to be used heavily. To give users an idea, 
the current spooler size 5006 blocks (=*64 million words) can hold 
approximately 20,000 cards or 132-column lines. 


3.1.2 One Mode Addressing 


Users who intend to have a Bank or Page mode system only should delete 
the appropriate UFD: 



< PAG > 

< BNK > 



(K )} 


3*1.3 FORTRAN Considerations 

The user should next consider the system's FORTRAN capabilities. PDP-9 
users should call PATCH, and replace F4 supplied with the system with 
the binary file, F4X9, supplied in the PER UFD or separate tape, 
mounted on unit *0’ (for RF15 system). 

$A -10 J (For RF15 system: $A v _^^^l_,-10 J) 

$ PATCH J 
>F4j 

>READR F4X9J 
>EXIT J 

PDP-15 users whose systems have the Floating Point Hardware should 

the system libraries in BNK and PAG with the libraries found in 
the extra DOS-15 Vnn Floating Point FORTRAN Option tape, DEC-15-ODFPA- 
A-UB. Before doing so, however, the system manager should consider 
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whether FOCAL will be used at the installation. If so, he must make 
an Execute file out of FOCAL. (FOCAL has not been modified to take 
advantage of Floating Point Hardware, and uses non-Floating Point OTS 
routines.) If the user has his own FOCAL routines, he should add them 
to FNEW (see Appendix C). 

$PAGE |_I ON (or OFF, as desired) 

$Ai_i SYSi_i -4 (assign desired output UIC) 

$CHAIN 


>FOCAL (ALT MODE) 

>(ALT MODE) 

>FOCAL , FNEW (ALT MODE) 
>(ALT MODE) 


Then the system manager should replace the standard library with the 
Floating Point Library, found on the option tape mounted on unit 1 1 *; 


$PIP 



• LIBR ^ BIN " {5?l} 


* FPAG u BIN \ 
*FBNK i_j BIN/ 


Users should then replace the F4* (FORTRAN! supplied as a system pro-* 
gram with the one from the Floating Point Tape: 

$ A {Si} -10 J. 

$P'ATCHV 

>F4J 

>READR FPF4X^ 

>EXIT^ 

3 O 1 0 4 Graphics 

When the proper FORTRAN routines have been installed, the user with a 
VT15 Graphics Display Processor should add the Graphics routines in 
the PER UFD or separate tape (for RF15 systems) to the system libraries 
in BNK or PAG* Before doing this, CIRCLE and ROTATE should be assembled 
under the current F4 compiler to produce the binaries: 
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<PER>U " 10/ {°f) CbNkD— 14 '" 15 ^ 

$UPDATEj 

>US«a) 

>1 ROTATE J 
>1 CIRCLE,*) 

>1 vtprimJ 

>1 DYLDRj 
>1 TRACKJ 
>1 LTORPBj 
>Cj 


(for RF15 system: 

$aJ^ ££>_, -io) 


3.1.5 VP15 Point Plotting Display 


The user with a VP15 Point Plotting Display should add the following 
routines to the libraries: 


$Ai_j (^LJ <PER> e-1 



-14,-15 


(for RF15 system 
$A^ Jg)i_.-lj2f) 


$ UPDATE* ) 
>UPDATE Vnn J 

>vs<-J 

>1 VECTOR*) 

>1 FORTj 
>1 NUVALj 

>cj 


The user can transfer VPA.S BIN into IOS, UIC and rename it to VPA.BIN. 


3.1.6 Unichannel Based System Considerations 

The MACH Assembler is delivered as an 8K (Local-11 memory) version. 
This version will not work on the 4K and 12K unichannels. Before 
altering PIREX or the spooler the proper MACH assembler must be 
installed. See the DOS Assembly Parameters manual (DEC-15-ODAPA-A-D) 
for the procedure to install a 4K or 12K MACH. 

The PIREX paper tape (DEC-15-XUCMA-A-D) is supplied in its initial 
configuration with RK and LP drivers. 

The spooler, resident on disk under UIC PER, is configured for line 
printer (LP) only e 
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1 . 







, 




The following procedure permits reconfiguration of PIREX to produce 
a version compatible with a specific site's configuration. 

a. Under UIC PER, utilize the editor (EDIT) toinclude 

or delete from PIREX for the following assembly 
1 - 


parameters s 192 


i) 

$RK=100000 

;(RK05 disk) 

2) 

$LP=40000 

;(LP/LS/LV Printer) 

3) 

$CD=20000 

", (CR11 Card Reader) 

4) 

$PL=10000 

;(XYll Plotter) 


b. Assemble the source with MAC11 to produce a new 
PIREX paper tape. 

Typing : 

$ MAC11 

> B*-PIREX XXX ( ALT ) 

will cause the assembly of a new PIREX onto paper tape. 3 

2o To change the Spooler S s configuration utilize the following 
procedure. 

a. Under UIC PER with Editor (EDIT) to include or 
delete from the Spooler (SP0L11) the following 
assembly parameter* 


i) 

$LP=400j3/2f 

;(RK05 

disk) 

2) 

$CD=20000 

; (CR11 

card reader) 

3) 

$PL=10000 

;(XYll 

Plotter) 


b. Assemble the source with MAC11 to produce a new SPOLll 
Paper tape. 

Typing s 

$ MAC11 

> LB ^-SPOLll XXX (ALT) 


deleting a parameter deletes the device driver , adding a parameter 

includes the associated driver* 

2 

The initial parameters are $rk and $LP. 

3 For more information on MAC11, see the MACH User's Manual 
(DEC -15 “LMCMA-" A”D) * 
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will cause the assembly of a New SP0L11 onto paper tape 
and produce a listing * 

c. Assemble SPLIMG XXX under MACRO-15 using the assembly 
SPOLSZ. (The value of the assembly parameter SPOLSZ 
may be found on about the fourth page of the SPOLSZ 
listing.} 

d. Turn API OFF * 

e. Place the new SP0L11 paper tape in the reader. 

f. Using GLOAD run SPLIMG. 

$ GLOAD 

>f-SPLIMG_(ALT) 

g B Assemble SP0L15 XXX using the SPOLSZ assembly parameter 
(See c above) and the FB assembly parameter. (Use PIP; 

L TT^RK (L) to acquire the FB parameter.) 

ho Under the MICLOG Patch the new SP0L15 absolute binary into 
the SPOOL program. 

$A RK <PER> -10 

$ PATCH 

>SPOOL 

> READ SPOL15 
>EXIT 

i* Reassemble the PDP-15 side handlers corresponding to the de¬ 
vices to be spooled. These are located under the PER UFD. 

1. For those devices to be spooled do not use the NOSPL=0 
parameter. 

2. For any device that is to be no longer spooled* use the 
NOSPL=J$ parameter. 

3. See the DOS-15 Assembly Parameters Manual for any other 
relevant assembly parameters. 

j. Transfer the newly assembled and suitably renamed DOS-15 
handler binaries to the IOS UFD, 

The updated spooler is now ready to run. 

3.1.7 UNICHANNEL-15 Option 1 

Users who have the UC15 optional hardware are supplied with a DOS-15 
Vnn UC15 option tape* DEC-15-ODUCA-A-UC* containing the required soft 
ware. This tape contains software to permit the RF or RP to be the 
system device. To use RK as the systems device users must obtain the 
RK05 disk restore tapes. In the following illustration to add the 
UC15 option software to the existing system* RP is the systems device 

1 The uc-15 option is a non-spooled UC-15 package intended for use 
with systems utilizing an RP02 or RF15 as the primary system 1 s disk. 
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The installation of the UC15 option is completely described in the 
"UC15 OPTION" Appendix in the UNICHANNEL-15 Software Manual 
(DEC-15-XUCMA-A-D). 

A summary of the required steps is provided for purposes of 
reference only; 

1) Assemble the UC15 OPTION-RBOOT 1 producing a new papertape. 

2) Patch the special RESMON, DOSNRM, DOSBCD and SGNBLK RPA 1 
onto the system. 

3) Load the supplied PIREX papertape using ABSL11. 

4) REBOOT DOS-15 using the new UC15-RPB00T 1 . 

5) RUN SGEN to install MACll 2 as a system program, 

6) Use patch to update FA, PS, SA for MACH. 

7) Assemble MACINT, MACIMG and load the MACH papertape. 

8) Patch MACINT onto the system, 

9) Tailor PIREX for your installation's configuration. 

10) Assemble and move the UNICHANNEL DOS-15 handlers into [IOS]. 

11) Run SGEN to install new devices (XY and RK) and new skips 
(LP and CD), 

12) Load the tailored PIREX using ABSLll. 

13) REBOOT DOS-15 using the UC15 OPTION-RPBOOT 1 papertape. 





*Substitute RF for RP where appropriate. 

Remember to reply "N" to the "UC15 Config?" question. 
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3.1-8 Source Files in PER UFD or Separate Tape (For RF15 Systems) 

The user should next decide whether he needs any of the source files 
supplied in PER UFD or separate tape (for RF15 system). If so, he 
should assemble them via MACR0/MAC11* Appendix C describes the assem— 
bly parameters relevant to all the source files in PER. Appendix C 
also describes where in the system the assembled files should be 
inserted. 

3.1.9 Second DOSGEN Run 

The user should run through DOSGEN, to add any devices and system pro— 
grams needed for the system. 

3.1.10 PATCH 

The user should call PATCH, to add any system programs for which 
DOSGEN has reserved space. 


3.1.11 PIP 

The user should call PIP, and transfer to IOS any handlers added to 
the system. 1 The user should then save the PER UFD on a tape, if not 
already present, for future reference, and delete the PERUFD from the 
system in order to recoup space. 

3.1.12 Copy the System 

Finally, the user should make at least one copy of the new system, via 
the DOSSAV program. 

3.2 USING DOSGEN AFTER THE FIRST TIME 

The system manager may call DOSGEN at any time, in order to modify the 
system. Changes in system parameters, and deletion of devices, device 
handlers or system programs require no advance preparation. Addition 
of core-image system programs, however, may require some preliminary 
work with PIP. 





'once device handlers have been transferred to IOS, they must be re¬ 
named, if necessary, to the names assigned in Sections B and C„ The 
PIP "R" command will rename files. 
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Core image system programs and the spooler area must occupy contiguous 
blocks on the system device * A running system may have sufficient 
free blocks to accept a new core image file, but no set of contiguous, 
free blocks. In such an instance, the user will have to transfer 
files from any of the UFD 0 s on the system device to another mass 
storage medium, and then run DOSGEN. After the DOSGEN run, PATCH can 
add the system files, and PIP can bring back the transferred UFD 9 s. 
UFD 8 s need not have contiguous disk storage. 





APPENDIX A 


DOSSAV OPERATING INSTRUCTIONS 
DOSSAV is the save/restore system for DOS-15. 

DOSSAV saves and restores to/from DECdisk, Disk Cartridges, Disk Packs, 
DECtape and magtape. A DECdisk system can be saved on and restored 
from DECtape, magtape. Disk Cartridge and Disk Pack. A Disk Pack or 
Disk Cartridge system can use DECtape and magtape. 

Once loaded, DOSSAV asks for all necessary information, such as input 
and output device, unit numbers and, in the case of magtape, parity 
and density. 

GENERAL INSTRUCTION: 


The user must type a Carriage Return after all entries, including the 
character typed to restart after errors. For UC15 system, start up 
PIREX as indicated below. 

To load PIREX, place the ABS11 paper tape in the PDP-15's paper tape 
reader. Place the ENABLE/HALT switch on the PDP-11 in the HALT posi¬ 
tion. Press the STOP and RESET switches on the PDP-15 simultaneously. 
Set the ADDRESS switches on the PDP-15 to 17700. Press the READIN 
switch on the PDP-15. When the readin operation is completed and the 
PDP-15 has halted, set the PDP-11 switch register to: 

60000 for 4K local memory on the PDP-11 
100000 for 8K local memory on the PDP-11 
120000 for 12K local memory on the PDP-11 

and depress the PDP-11 LOAD ADDR switch, then set the ENABLE/HALT 
switch on the PDP-11 to ENABLE, and finally depress the PDP-11 START 
switch. 

Remove ABS11 from the paper tape reader, and reload it with the PIREX 
paper tape. Press CONTINUE on the PDP-15. This will cause the ABS11 
program (which has two segments: A PDP-11 segment, and a PDP-15 seg¬ 
ment) to read in PIREX (which is a PDP-11 absolute binary tape) via 
the PDP-15 segment and load it into PDP-11 lower memory via the PDP-11 
segment. 



When the FIREX paper tape has been read in, the PDP-15 will halt, and 
the PDP-11 will be running PIREX. Remove the PIREX paper tape from the 
reader, At this point the UNICHANNEL Peripheral Processor has been 
loaded and is waiting for an I/O request from DOS-15. 

A.1 RESTORING SYSTEMS 

The following examples illustrate how to put the systems distributed by 
Digital on DECtape or magtape onto a DECdisk, Disk Pack or Disk Cartridge. 
The user responses are underlined. The RK05 based systems start up 
PIREX as described in GENERAL INSTRUCTION, above, before starting up 
DOSSAV. DOSSAV resides on a paper tape, which must be (HRM) loaded 
at 37720 (restart 34200). 

1. To restore a DECdisk system from DECtape (1 of 2 on Unit 1 
and 2 of 2 on Unit 2) 


DOSSAV Vnn 

INPUT DEVICE? DTj 

UNIT NO? l) 

OUTPUT DEVICE? DKj 
DATE CREATED: 06 Jun 73 

TAPE DONE. MOUNT ANOTHER 


/Note that if DK is typed no 
/unit number is requested. 
/At this point, 

/type 2 on the key¬ 
board followed by Carriage 
/RETURN. 


To restore a DECdisk system from magtape (on Unit 0) 


DOSSAV Vnn 
INPUT DEVICE? 

UNIT NO? 0j 
TRACK (7 OR 9)? 

DENSITY (2,5,8)? 

PARITY (E OR 0)? 

OUTPUT DEVICE s DK j 
DATE CREATED: 06-JUN-73 


mtJ 
7 J 


8j 


NOTE 

All DOS-15 System Restore magtapes 
distributed by Digital are 800 BPI, 
odd parity.For 9 track units, DOSSAV 
assumes. 800 BPI. 

To restore a Disk Pack system from DECtape (1 of 2 on Unit 1 
and 2 of 2 on Unit 2)s 


DOSSAV Vnn 
INPUT DEVICE? 
UNIT NO? 1 J 
OUTPUT DEVICE? 
UNIT NO? 0J 
DATE CREATED: 


dtJ 

dp) 

06-JUN-73 


TAPE DONE, MOUNT ANOTHER 

2 ) 


At this point, type 2 on the 
teleprinter followed by a 
Carriage RETURN. 
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4. To restore a Disk Pack system from magtape (on Unit 1): 

DOSSAV Vnn 

INPUT DEVICE? MTV 

UNIT NO? lJ_ 

TRACK (7 OR 9)? ]_J 

DENSITY (2,5,8)? 8j 
PARITY (E OR O)? CO 
OUTPUT DEVICE? DPj ~ 

UNIT NO? 

DATE CREATED! 06-JUN-73 


5. To restore a Disk Cartridge system from DECtapes on Units 1, 2, 


DOSSAV Vnn 
INPUT DEVICE? DTV 
UNIT NO? ij 
OUTPUT DEVICE? RKj 
UNIT NO? 0) 

DATE CREATED: 06-JUN-73 
TAPE DONE. MOUNT ANOTHER 
2 ) 

TAPE DONE. MOUNT ANOTHER 

3P 


(The user mounted the next tape on 
unit number 2, then typed 2 J 
to continue) 

(The user mounted the next tape on 
unit number 3, then typed 3 J 
to continue) 


TAPE DONE• 

o 


MOUNT ANOTHER (The user mounted the next tape on 
unit Number 4, then typed 4 J 
to continue) 


DOSSAV Vnn 

INPUT DEVICE? (Operation complete) 


6, To restore a Disk Cartridge from magtape Unit 1: 

DOSSAV Vnn 
INPUT DEVICE? MTj 
UNIT NO? 1 J 
TRACK (7 OR 9)? 7j 
DENSITY (2,5,8)? 8_J 

PARITY (E OR O)? 0 J 

OUTPUT DEVICE? RKj 
UNIT #? 0p 

DATE CREATED: 06-JUN-73 
DOSSAV Vnn 

INPUT DEVICE? (Operation complete) 


It is possible to restore to the DECdisk a software system which was 
created for a machine smaller (different number of DECdisk platters) 
than the one being restored to. DOSSAV does all the necessary adjust¬ 
ments of the SAT's 1 . Therefore, the restore tapes issued by Digital 
for a 1-platter system can be restored to any system. Note that this 
should only be done with the master tape(s) which have block 1775g 

1 SAT's: Storage Allocation Tables - i.e., bit maps. 


3, and 4 
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free. That block is needed during the restore for five or more DECdisk 
platters. It is not possible to restore a software system which is 
larger than the hardware. (For example, one cannot restore a 3-platter 
system onto a 1-platter configuration.) 

The system can then be bootstrapped from the appropriate disk. See the 
DOS Keyboard Command Guide (DEC-15-0DKCA-A-D). 

A.2 SAVING SYSTEMS 

Once the user has tailored the system to his specific configuration, he 
will want to save that system for future restorations. To do that, 
simply reverse the procedure above. To illustrate, consider Example 1 
above and the changes necessary to it to create a restore tape. 

To save a DECdisk system to DECtape (on Units 1 and 2); 

DOSSAV Vnn 
INPUT DEVICE? DKJ 
OUTPUT DEVICE? DT J 
UNIT No? 1 2 

TAPE DONE. MOUNT ANOTHER At this point, type 2 on the 

„ » keyboard followed by a Carriage 

RETURN. 

Note that DOSSAV allows for as many DECtapes and magtapes as are 
necessary to hold the system. 

A.3 ERROR CONDITIONS AND MESSAGES 


Recoverable errors during command string decoding ; If a question is 
answered incorrectly, DOSSAV outputs an appropriate error message and 
then repeats the question. These error messages ares 


ILLEGAL DEVICE 


BAD TRACK 
BAD DENSITY 

BAD PARITY 


An illegal device mnemonic was typed 
(something other than DP, DK, RK, DT, 
or MT) or an illegal combination of 
devices was typed (i.e«, input - DT and 
output = MT). 

Something other than 7 or 9 was typed. 

Something other than 2 (200) , 5 (556) , 
or 8 (800) was typed. 

Something other than E (even) or 0 (odd) was 
typed. 


Recoverable errors during operations : If it is possible to recover 
from an error, DOSSAV attempts to do it. The error message is output 
to the console. After the problem has been corrected, any character 
on the keyboard followed by a Carriage RETURN resumes operation. 
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TAPE NOT READY 


The DECtape or magtape unit is off line 
or not write enabled. 

DISK NOT READY DECdisk is write locked. 

DISK PACK NOT READY The Disk Pack or Disk Cartridge unit is not 

ready. 

Unrecoverable errors: Primarily hardware errors, from which DOSSAV 
cannot recover. After the error message has been output, DOSSAV 
restarts. DOSSAV retries five times on parity error, before issuing 
an unrecoverable error message.. 


DECTAPE ERROR 
MAGTAPE ERROR 
DISK ERROR 
DISK PACK ERROR 

ATTEMPT TO RESTORE SYSTEM TO WRONG DISK 

To protect users who have access 
to more than one type of disk and 
who may have several sets of 
restore tapes, all restore tapes 
are created with the mnemonic of 
the disk type in the first SAT* 

DOSSAV checks this code against 
the output device code* If they 
differ, this message is output* 

BLK 1775 OCCUPIED. NO 2ND SAT CREATED 

A DECdisk system created for 4 or 
fewer platters is restored to a machine 
with 5 or more platters and block 1775 
is already used. Therefore, no second 
SAT is created. A master tape was not 
used to make the restore. 


XX ERR IGN 


where xx = DK or DP or RK S 

This error is typed on the console, 
and the PDP-15 halts. This reports 
that "Read/Write check” errors 
occurred more than 12 Q time during 
a save or restore process. The bad 
block number is present in the PDP-15 
AC. Users can continue the save or 
restore process by pressing the 
continue switch on the console of the 
machine. 
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A. 4 TAPE STRUCTURE 


The restore tapes are structured as follows: The first SAT of the 
system is the first block put on the tape. This SAT, which is never 
restored to the disk, has two words modified: word 2 contains the 
creation date (taken from .SCOM+47) and word 376 contains the device 
mnemonic ( .SIXBT , right justified). All the occupied blocks referenced 
by this SAT are then put sequentially on the tape. The second SAT, 
if there is one, is then put on, and so on. This structure enables 
use of magtape, which is a sequential only device. 


A*5 DOSSAV Restrictions 


It is not possible to save or restore magtapes with even 
parity. 

DOSSAV fails when^two DECtapes are on line with the same 
unit number. It is necessary to restart under such 
circumstances 
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APPENDIX B 


DIRECTORY LISTINGS: BNK p PAG AND IOS 
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p t i r s 


1 7 « 

' 1 R F P 

S} kf« 


nnr 

n T M 

1 *» 

$0 mM AQm? A 

FYF^iT 

at vi 

1 

2?-^A 3^74 

Fnr *i 

a T M 

97 

?%MA9»74 

.LT*» 

a I M 

1 

2*-"AP»74 

. L n* n 

e T M 

1 1 

??-MA9.74 

TMS A! i 

apr 

* 


I N R sr P 3 

r p r 

7 

P9.MA9.74 

T M S T P <" 

« T M 

1 



nT»fffTnoy Lt^Ttvir, 

f P A G1 



ai 

K ^ 


1 7 

IKFR 

FTI FR 


1 7 * 

1 1 $ P P 

ai 



pru 

0 T M 


1 ** 

AP«?4 

FXF ^IIT 

q T M 


* 

49^74 

f nr a i 

0 J M 



99®MAP®74 

. L T 3 » 

0T vi 


i f?y 

2R.MAP-74 

s Ln a n 

a T M 


i i 

2?®map®74 

I M S A i 1 

?t?r 



£7-MA9-74 

I.NSP'00 

«r 


7 

A®^74 

jMSTPr 

0 f M 


1 

2?-MAP<®74 



25-JUL-74 


directory LISTING 

CIOS) 

1242 

FREE 

BLKb 


36 

USER 

files 


273 

USER 

BLKS 


COB. 

SIN 

3 

S3-JUL-74 

OKA, 

BIN 

16 

gg«JUl®74 

QKB. 

bin 

14 

2S-JUL-74 

DKC, 

BIN 

7 

23“JUU-74 

DFA. 

BIN 

17 

2S-JUL-74 

DPB. 

BIN 

IS 

29-JUL-74 

DPC. 

BIN 

10 

2S-JUU-74 

DTA„ 

SIN 

11 

25»JUU-74 

OTC. 

BIN 

3 

2S-JUL.-74 

DTD . 

BIN 

li 

2S=JUL«74 

DTE. 

BIN 

7 

25®JUL»?4 

DTP. 

BIN 

4 

23-JUL-74 

LKA. 

BIN 

3 

2S-JUU-74 

LPA. 

BIN 

3 

US®JUL-74 

LTX. 

BIN 

I 

2SaJUL®74 

mta. 

BIN 

12 

28®JUL“74 

MTC. 

BIN 

S 

2S-.JUL-74 

MTF. 

BIN 

5 

25®JUL-74 

PPA. 

BIN 

3 

23®JUL-74 

PPB. 

BIN 

2 

§5®JUt«74 

PPC. 

BIN 

2 

2S®JUL®74 

PRA. 

BIN 

3 

8S®JUL®74 

PRB. 

BIN 

2 

25®JUL-74 

RK A, 

BIN 

li 

25-JUL-74 

rkb. 

BIN 

14 

28-JUL-74 

RKC. 

BIN 

li 

2S»JUL"74 

VPA. 

BIN 

4 

2§®JUL®74 

VTA. 

BIN 

3 

23®JUL-74 

VW A a 

BIN 

2 

2S®JUL®?4 

XVA. 

SIN 

4 

25®JUL®74 


*°nly for RK05/RK15 systems. CDB.BIN will be the CR03B, 

DEC 029 code handler for RF15 and RP15 systems while for RK05/RK15 

fpa^TM lt iV 1 i 1 b u the CR11? DEC 0 29 code unspooled handler 
LPA.Bra will be the LP15 handler for the RF15 and RP15 systems 

while for RK05/RK15 systems it will be the LP11/LS11 spooled 

handlers. XYA.BIN present in RK05/RF15 system will be the spooled 
version of the handler® 
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APPENDIX C 


PER UFD AND SOURCE ASSEMBLY PARAMETERS 
The following is a listing of the PER UFD; 


o t p r r t r 

!»y T ^ T T K, f^ 

f PFfM 

« $ 9 

rprr 

«! H 


11 

< I $ F p 

Ft 1 PR 


1 HI 

»1 

B! KS 


C H rj 

XXX 

1 & 

1 a^-74 

C T&HI c 

SRC 

7 

P9-MA9-74 


XXX 

49 

21-AP9-74 

nyi 

BIN 

9 

13-MAP-74 

F N F 

xxx 


10.M A P 4 

PHR T 

BIN 

1 

1 Q.MAP»74 

F4X3 

BIN 


2R-MAP-74 

[_ P ^ 

BIN 


1Q«MAP®74 

L D A ‘1 1 55 

XXX 

19 

lO»MAP-74 


BIN 

1 

t 9.MA9-74 

L r n > o * 

BIN 

1 

10-MA9-74 

N f 1V M 

BIN 

1 

1A9*74 

RHT Hr 

SRC 



T*Ar< 

BIN 

9 

1 9 e9 MA^ 0 74 

V F C T n p 

SRC 

4 

27»MAP-74 

VP 41 <5 

BIN 

* 

i 

V?P? Tm 

BIN 

7 

!Q*MA9»74 

Loir. 

XXX 

41 

1 

M & c T M 

XXX 

1 1 

tP«MAP«74 

H A C T W T 

XXX 

47 

i 

P TH p ¥ 

XXX 

* 


S°L T Mr; 

XXX 

1 1 

t 

SPm i i 

E 0 4 

914 

13®MAQ®74 

SPni'i p 

XXX 


| P«.MAQ«74 

X V u 1 

XXX 


10«»MAP»74 


PER con tains-"-source files; 


NOTE; 


DOSBCD XXX 
CD * DOS XXX 
FNEW XXX 
LPA*15 XXX 


XXX is the current version 
number - see DOS Assembly 
Parameters document 
(DEC-15-ODAPA-A-D) . 


Those installations which have their own FOCAL routines may want to 
use EDIT 1 s GET command to add their sources for FNEW* If these 
sources substitute for others already present, EDIT can delete the 
old routines* Once FNEW is completed, MACRO produces FNEW BIN on 



some device. Assign this device to .DAT -10. Then, the following 
commands to UPDATE delete the old FNEW, and insert the new one: 


$UPDATE 
UPDATE Vnn 
> US+ J 
>D FNEWj 

>1 FNEWJ 
>cj^ 


The Assembly Parameters document (DEC-15-ODAPA-A-D) shows the 
assembly parameters that produce all the possible variations of 
binary files. Note that once assembled, programs put in the IOS UFD 
must be renamed. For example, the binary produced from assembling 
LPA.15 048 is LPA.15 BIN. When this program is put in the IOS UFD, it 
must be renamed to LPA. BIN. 

Any number of positive .DAT slots over 20g requires reassembly of FIOPS 

and .FLTB. These sources may be purchased from Digital Equipment 

Corporation. Assembly parameter for .FLTB is: FLTB=n<_77 8 . Assembly 

parameter for FIOPS is: DKTBSZ=n<77 . 

— 8 

On RK05/RK15 the PER UIC? also contains the following source files? 


MAC I MG 

XXX 

I 5 

11-FEB-74 

MACINI 

XXX 

47 

i 1 “FEB* 

°74 

P I REX 

XXX 

313 

l 1 - FEB- 

•74 

SPLIM6 

XXX 

13 

1 1 - FEB« 

-74 

SP0L11 

XXX 

230 

1 1 - FEB- 

•74 

SPGL15 

XXX 

62 

1 1 -FEB e 

-74 

LP U ® 

XXX 

43 

i 1 - FEB- 

- 7 4 

X Y U e 

XXX 

66 

i 1 - FEB- 

•74 


NOTE 


XXX is the current version number-see DOS 
Assembly Parameters document (DEO15-0DAPA-A-D) . 
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HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS, MAILING LIST 


The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products. Newsletters are published monthly, 
and contain announcements of new and revised software, programming 
notes, software problems and solutions, and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published periodi¬ 
cally. For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to: 

Software Communications 

P. 0. Box F 

Maynard, Massachusetts 01754 


I 


SOFTWARE PROBLEMS 


Questions or problems relating to Digital's software should be reported 
to a Software Support Specialist. A specialist is located in each 
Digital Sales Office in the United States. In Europe, software problem 
reporting centers are in the following cities. 


Reading, England 
Paris, France 
The Hague, Holland 
Tel Aviv, Israel 


Milan, Italy 
Solna, Sweden 
Geneva, Switzerland 
Munich, West Germany 


Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 





PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In 
the United States, send orders to the nearest distribution center. 


Digital Equipment Corporation 
Software Distribution Center 
146 Main Street 
Maynard, Massachusetts 01754 


Digital Equipment Corporation 
Software Distribution Center 
1400 Terra Bella 

Mountain View, California 94043 


Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 


USERS SOCIETY 

DECUS, Digital Equipment Computer Users Society, maintains a user ex- 
change center for user-written programs and technical application in¬ 
formation. A catalog of existing programs is available. The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia. For information on the 
society and membership application forms, write to: 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


DECUS 

Digital Equipment 
P.O„ Box 340 
1211 Geneva 26 
Switzerland 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page). 


Did you find errors in this manual? If so, specify by page. 





Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 

I I Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

1 I User with little programming experience 
I I Student programmer 

□ Non-programmer interested in computer concepts and capabilities 

Name----- Date_ 

Organization ____ 

Street________ 

cit Y-—--State,--Zip Code_ 

or 

Country 

If you do not require a written reply, please check here, I—I 
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